home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / arce124.arc / ARCE124.DOC < prev   
Text File  |  1986-04-01  |  5KB  |  184 lines
  1.  
  2. ARCE Command
  3. ------------
  4.  
  5. Purpose:  To extract files from an ARC archive file.
  6.  
  7. Format:   ARCE    [d:][path]filename.ext    [filespecs...] [d:outpath] [/R]
  8.  
  9. Remarks:  The drive and path names are optional. If omitted, the
  10.     current drive and path name is used.
  11.  
  12.     The filename must be supplied. The extension defaults
  13.     to ARC. All files matching the supplied filename are
  14.     processed. The ARC filename may contain the * and ?
  15.     wildcard characters.
  16.  
  17.     If no filespecs are supplied, all files are extracted.
  18.     Otherwise, only those ARC members which match one of the
  19.     up to 16 filespecs are extracted.
  20.  
  21.     The extracted files may be placed on another drive, and/or
  22.     in another subdirectory by following the optional filespecs
  23.     with a drive designator and/or path name.
  24.  
  25.     If the file being extracted already exists, you are asked
  26.     whether or not you want to over-write it. You may use the
  27.     /R option to bypass this prompt.
  28.  
  29.  
  30.  Examples:
  31.  --------
  32.  
  33.     o  Extract all file from TEST.ARC onto the current drive:
  34.  
  35.           ARCE TEST
  36.  
  37.     o  Extract only file with an extension of .ASM from the
  38.        archive SOURCE.ARC on drive B and in subdirectory SAVE:
  39.  
  40.           ARCE B:\SAVE\SOURCE *.ASM
  41.  
  42.     o  Extract all files from all ARC files in the subdirectory
  43.        called TEST on drive C:
  44.  
  45.           ARCE C:\TEST\*
  46.  
  47.     o  Extract all files from PROGA.ARC and place the files in
  48.        subdirectory OLD on drive B:
  49.  
  50.           ARCE PROGA.ARC B:\OLD
  51.  
  52.     o  Extract all files with an extension of .COM and .EXE from
  53.        the archive PROGS.ARC in directory NEW\WORK on drive B,
  54.        and place the them in subdirectory SAVE\TEST on drive A;
  55.        replace existing file:
  56.  
  57.           ARCE B:\NEW\WORK\PROGS *.COM *.EXE A:\SAVE\TEST /R
  58.  
  59.  
  60.  Error Messages:
  61.  --------------
  62.  
  63.     'filename - premature EOF reading '
  64.      Data is missing from the archive file.
  65.      The program is terminated.
  66.  
  67.  
  68.     'filename - unable to set file datestamp'
  69.      The file datestamp is set to the current date and time,
  70.      and the next archive member is processed.
  71.  
  72.  
  73.     'filename - WARNING: file CRC does not match!'
  74.      The extracted member is left on the output disk,
  75.      and the next archive member is processed. The file
  76.      is probably invalid but is left on the disk for
  77.      your examination.
  78.  
  79.  
  80.     'Invalid filespec(s)'
  81.      The filespec syntax is incorrect. The filename part may
  82.      be from 1 to eight characters, and may include the ? or *
  83.      wildcard characters. The extension may be none to three
  84.      characters, and may include wildcards.
  85.      There is a maximum of 16 filespecs allowed.
  86.      The program terminates.
  87.  
  88.  
  89.     'filename - file already exists. Overwrite it? (y/N) '
  90.      The member being extracted already exists. If you are
  91.      using a data path utility, the file may not actually be
  92.      in the subdirectory be used for output. Respond with the
  93.      letter Y to over-write the existing file, or respond with
  94.      the letter N to skip this member and continue to the next.
  95.  
  96.  
  97.     'Abort: Stack overflow'
  98.      The member being extracted has invalid data. The program
  99.      is terminated.
  100.  
  101.  
  102.     'filename - invalid decode tree count'
  103.      The member being extracted has invalid data. The program
  104.      is terminated.
  105.  
  106.  
  107.     'filename - new archive format 7 not yet supported'
  108.      Format 7 is a special file compression method used
  109.      internally by SEA, the authors of ARC. Processing
  110.      continues with the next archive member.
  111.  
  112.  
  113.     'Unable to open archive > arcname'
  114.      The specified ARC archive file was not found, or was
  115.      inaccesible. The program terminates.
  116.  
  117.  
  118.     'CREATE failed > filename'
  119.      There was insufficient directory space, or a failure
  120.      accessing the output disk. The program terminates.
  121.  
  122.  
  123.     'Invalid archive format!'
  124.      The archive file data is invalid. The program terminates.
  125.  
  126.  
  127.     'Incorrect DOS version'
  128.      Version 2.0 or later of PC DOS must be used. The program
  129.      terminates
  130.  
  131.  
  132.     'Not enough memory.'
  133.      A minimum of 112k bytes of memory is required. The program
  134.      terminates.
  135.  
  136.  
  137.     'I/O error reading from arcname'
  138.      An incorrectable error occurred attempting to read data
  139.      from the archive file. The program terminates.
  140.  
  141.  
  142.     'I/O error writing or disk full > filename'
  143.      There was not enough disk space to write the complete
  144.      archive member. The partially extracted file is scratched
  145.      and the program terminates.
  146.  
  147.  
  148.     'No matching file(s) found'
  149.      No archive files were found that matched the supplied
  150.      filename specifications. The program terminates.
  151.  
  152.  
  153.  Version history:
  154.  ---------------
  155.  
  156.     1.12 - 1/13/86, initial release
  157.     1.13 - 1/14/86, correct 'Not enough memory' checking
  158.     1.14 - 1/19/86, make displays MS-DOS compatible
  159.     1.15 - 1/24/86, add error messages for new ARC 5.0 formats
  160.     1.16 - 2/24/86, adds adaptive LZW decompression for code 8
  161.     1.17 - 3/02/86, adds file selection operands
  162.     1.18 - 3/04/86, optimizes performance
  163.             adds stack checking for munged LZ files
  164.     1.19 - 3/15/86, modifies CRC computation for more speed
  165.     1.20 - 3/16/85, minor changes
  166.     1.21 - 3/24/86, adds wildcards for ARC file name
  167.     1.22 - 3/25/86, improves UnCrunch performance
  168.     1.23 - 3/28/86, corrects problem with 0-byte files
  169.             adds outspec operand
  170.     1.24 - 4/01/86, increases stack size for 'crunched' files
  171.  
  172.  
  173.  Notice:
  174.  ------
  175.     By Vernon D. Buerg, Wayne Chin, and A. Kumar; for the IBM PC
  176.     using DOS 2.0 or later. All rights reserved.
  177.  
  178.         Vernon D. Buerg
  179.         456 Lakeshire Drive
  180.         Daly City, CA  94015
  181.         CompuServe: 70007,1212
  182.         Data/RBBS:  415-994-2944
  183.  
  184.